Mac Magazin/MacEasy 44

home *** CD-ROM | disk | FTP | other *** search

/ Mac Magazin/MacEasy 44 / Mac Magazin and MacEasy Magazine CD - Issue 44.iso / Magazin / Netzwerkspiele / Software / Demos & Shareware / WarBirds / WBv2.0r1PPC604.sea / WBv2.0r1PPC604 / For System Folder / InputSprocket Release Notes < prev next >

Wrap

Text File | 1997-04-17 | 15KB | 334 lines

InputSprocket 1.2 Release Notes ----------------- General Release Notes: This release involves many minor improvements to the InputSprocket drivers, including an improved user interface (UI) for axis. Some new drivers have also been added. Several problems and bugs have been addressed. A new resource has been defined (kISpApplicationResourceType = 'isap') which all applications which use InputSprocket should put (ID 0) in their resource fork. They should always set bit 0 (kISpAppResFlag_UsesInputSprocket) and set bit 1 (kISpAppResFlag_UsesISpInit) if they use the high level API (ie they call ISpInit, ISpConfig, etc... in other words they have a needs list). The rest of the bits and reserved fields should be set to 0. A new ISpElementKind has been added: kISpElementKind_Delta which specifies a Fixed point number of inches moved. InputSprocket Mouse and InputSprocket Kensington now register elements of this kind in the low level. The high level (through ISpConfigure) supports axis as well as delta kinds. This kind is very useful if you want to control a cursor. A new definition of ISpNeed can be used by defining USE_OLD_ISPNEED_STRUCT to 0. The first reserved field (a short) was changed to two UInt8s: playerNum and group. Use playerNum to tell the driver some needs are related to a particular player (on the same machine). The SprocketInvaders source code will be reved to use this field. Group is used to group items together, such as a look up, look down need (assuming you can't use an axis). You should also group items together that have the same effect, but are 'tuned' button, axis, and delta versions. The current ISp drivers do not use this hinting, yet. Some new definitions for the ISpNeedFlagBits have been added. If you use the new definition, make sure you check your code for cases where you were initializing the struct. You now may be misaligned, and many compilers will NOT generate a warning. High Level Release Notes: InputSprocket needs a 640x480 display (or larger) in order for its dialog to work. If you are asking DrawSprocket for a smaller display size than that you should switch out before calling InputSprocket. Information about how to get saved sets ('setl' Resources) to work is below under the InputSprocket 1.0 Release Notes AbsoluteTime and UnsignedWide are in the latest types.h (ETO #20 or later). /*typedef UnsignedWide AbsoluteTime; struct UnsignedWide {UInt32 hi;UInt32 lo;};*/ InputSprocket Mouse supplies pseudo-buttons in the high level for modifier keys in combination with mouse clicks. You will have at least four buttons (where some may actually be command/shift/control/option-click on one-button mice) for any mouse device. This should make it straightforward to port games which expect a two button mouse: use ISp with delta and button needs -- and dont worry about what type of device the user has. Changes from 1.1 ----------------- - InputSprocket Speech added back to distribution (crashing bug fixed) - InputSprocket Gravis supports Blackhawk and uses new UI (new save set format) - InputSprocket Thrustmaster uses new UI (new save set format) - InputSprocket Joy completely revised, renamed InputSprocket CH, now supports multiple devices seperately and supports up to 8 buttons and 4 hats per device (new save set format) - InputSprocket Kensington added, supports kensington devices regardless of their software - InputSprocket Sidewinder 3D Pro added, supports Microsoft Sidewinder joystick - InputSprocket AppleJack added, supports Pippin/AppleJack controller - InputSprocket Keyboard supports modifier keys in conjunction with a normal key (now either Escape or Cmd-Q are valid for kISpElementLabel_Btn_PauseResume) - Device and element strings have been reviewed, and some have been changed - ISpConfigure saves and restores the port. - A new function: ISpTimeToMicroseconds has been added. - There are some new bits defined for ISpNeedFlagBits. - Some new element labels have been added. - Old saved sets for devices other than mouse and keyboard do not work Incomplete list of devices input sprocket supports -------------------------------------------------- - Thrustmaster FCS, Thrustmaster WCS, Thrustmaster RCS - Gravis Gamepad, Gravis Firebird, Gravis Mousestick II, Gravis Blackhawk - CH Jetstick, CH Flightstick Pro, CH Pro Pedals, CH Pedals, CH F16 Fighterstick, CH Gamepad, CH Pro Throttle - Kensington TurboMouse 4.0, TurboMouse 5.0, Thinking Mouse, Kensington Mouse, CoStar Stringray trackball - Microsoft SideWinder 3D Pro - AppleJack/ Pippin Controller - Speech Recognition - Keyboard - traditional Apple 'id handler 1' mouse and 100% compatable mice - modern 'id handler 4' mice including Logitech Trackman Marble (see the technote "Space Aliens Ate My Mouse") Known Problems in 1.2 --------------------- - Kensington Mouse-in-a-box reports two buttons (only the first one works) - ALPS GlidePoint does not appear if ALPS software is installed (appears w/o ALPS software) - Mouse Systems Mouse does not appear if Mouse Systems software ('3-Button Power') is installed (appears as 1 button mouse w/o Mouse Systems software) - CH Trackball PRO does not appear - Thrustmaster software generates keyDowns if so configured with ThrustWare (fix is to configure all buttons to do nothing in ThrustWare) - Machines based on the Tanzania motherboard (Motorola StarMax, APS MPower, Apple PowerMacintosh 4400) will always show an extra Mouse device for the PS/2 mouse regardless whether one is plugged in (even though the 4400 has no PS/2 ports, the phantom ADB devices for them are still created). The PS/2 mouse only reports one button. - When a Sidewinder 3D Pro stick is connected, an extra mouse device is shown which is active when the 'mouse/joystick' switch is switched to 'mouse'. - It is unstable to have multiple applications use InputSprocket simultaneously. If your application can be suspended and uses InputSprocket you should use ISpShutdown and ISpStartup so that InputSprocket is off while you are in the background. This is a bug (since 1.0) and will be fixed in the next version. If you are a user you can work around this problem by not running more than one InputSprocket application at the same time. - When debugging, you may need to deactivate the Mouse and Keyboard drivers in order to be able to interact with your debugger. InputSprocket 1.1 Release Notes ----------------- General Release Notes: We recommend that if you are using input sprocket version greater than 1.02 that you no longer support any third party joystick APIs. You must not support those APIs at the same time as you have InputSprocket devices enabled. High Level Release Notes: If you are using InputSprocket via the high level (ISpConfigure and ISpInit and so on). We recommend that you only use the axis and button data types and build the controls that you need out of those types. This will get you the best support. Many of the drivers are going to only primarily emulate those datatypes. Known Problems in 1.1 --------------------- - Kensington Trackball does not appear if Kensington software is installed (appears w/o Kensington software) - ALPS GlidePoint does not appear if ALPS software is installed (appears w/o ALPS software) - Mouse Systems Mouse does not appear if Mouse Systems software ('3-Button Power') is installed (appears as 1 button mouse w/o Mouse Systems software) - CoStar Stingray Trackball does not appear if CoStar software ('Stingray') is installed (appears w/o CoStar software) - CH Trackball PRO does not appear - Thrustmaster software generates keyDowns if so configured with ThrustWare (fix is to configure all buttons to do nothing in ThrustWare) Changes from 1.02 ----------------- - new APIs (ISpStartup, ISpShutdown, ISpTickle, ISpDevices_ActivateClass, ISpDevices_DeactivateClass) - some general ui improvements in both appearance and performance have been made - new driver InputSprocket Joy (supports some features of JoyManager devices -- ie mainly CH products) - new driver InputSprocket Thrustmaster (supports FCS, WCS, RCS) - new driver InputSprocket Gravis (supports MouseStick, Firebird, GamePad) - new driver InputSprocket Speech (you must activate explicitly and requires ISpTickle be called) - InputSprocket Mouse changed to have new UI and is implemented via ADBMgr directly instead of a CursorDeviceMgr Patch - InputSprocket Keyboard has been slightly changed if there is only one page - driver function to plot icons has been changed (faster) - bug when you select a 0 length name to save a set has been fixed - bug involving choosing monitor has been fixed (might chose something other than the main monitor randomly) - CH Flightstick, CH Gamepad, CH Jetstick and MacEnjoy no longer generate a mouse device - a crashing bug involving multiple applications using input sprocket simultaniously has been fixed - a very small memory leak involving ISpConfigure has been fixed - DONT_USE_OLD_INPUT_SPROCKET_LABELS changed to USE_OLD_INPUT_SPROCKET_LABELS in InputSprocket.h - a bug where InputSprocket Keyboard and InputSprocket Mouse called InitGraf has been fixed InputSprocket Speech Notes -------------------------- - you must call ISpTickle in order for InputSprocket Speech to work - you must call ISpDevices_ActivateClass(kISpDeviceClass_SpeechRecognition) to turn InputSprocket Speech on - requires SpeechRecognition extension 1.5.1 (PlainTalk 1.5) InputSprocket Joy Notes ----------------------- - supports all JoyManager devices as a single input sprocket device. - UI may show popups for controls the device does not have - JoySimpleData based - only supports the trigger and three additional buttons - digital pointing devices (ex. CH Gamepad's pad) are treated as a pair of axis not a POV Hat InputSprocket 1.02 Release Notes ----------------- There is a new InputSprocket.h that has new versions of the names for the labels as well as additional labels. The following bugs were fixed in the 1.01 or the 1.02 releases. - keyboard ui now generates better names than Min/Max for axis if ElementLabel is useful - various problems with alignment and growing of dialog were fixed - flickering with icons in thrustmaster and mouse fixed - stub library included in this release with file type 'stub' - axis flipping check box now works again for the mouse driver - ISpDevices_Extract functions no work when an exact count is passed to them - Icon plotting is more robust. - The OK button is no longer hilited when the keyboard is active. - InputSprocket will now unload the drivers when the last fragment is unloaded - InputSprocket no longer leaks memory when you quit in the suspended state - when there are no devices to configure and ISpConfigure is called it will display a warning instead of doing nothing - ISpSuspend no longer leaks 10,000 bytes every call The following bugs are known: -There is an incompatability with the mouse driver and the Kensignton trackball software that causes no mice devices to appear. -There is a incompatability with the Kensington trackball that causes an extra mouse device to appear when the hardware is installed and the software is not installed. InputSprocket 1.0 Release Notes ----------------- Please report all bugs to sprockets@adr.apple.com! Release Components ------------------ InputSprocket Release Notes - this file InputSprocket.h - the header file to compile with InputSprocketLib - release version of the library InputSprocketDebugLib - debugging version of the library InputSprocketStubLib - version of the library to link to InputSprocket Keyboard - keyboard plug-in InputSprocket Mouse - mouse plug-in InputSprocketTest - test program InputSprocketTest.µ - Metrowerks 8 project to build test InputSprocketTest Sources - sources for test program Place InputSprocket Keyboard, InputSprocket Mouse and InputSprocketLib or InputSprocketDebugLib in the Extensions folder. Place InputSprocket.h in your development environment's C Headers folder. Place InputSprocketStubLib in your development environment's Libraries folder. WARNING: don't place both the debugging and non-debugging versions of the library in the search path or you will not be sure which version you will be using. Dependencies ------------ InputSprocket requires the latest Universal Headers -- version 2.1.2 or later. You can find them on E.T.O. #20, the MacOS SDK CD-ROMs, Apple's web-site, or a number of other locations. If you have a problem with the "AbsoluteTime" type usage, then you aren't using the latest Types.h file. Compatability with Prereleases ------------------------------ InputSprocket 1.0 is not compatible with any of the pre-release versions of InputSprocket. You should throw out all DR versions. Changes to 'setl' Resource -------------------------- The format for the set list resource ('setl') was changed at the last minute. A resedit TMPL resource is automatically installed in the preference file and the format is as follows: -- header -- Version (4 bytes) The current version is now 2. Count (4 bytes) -- each entry -- name (64 bytes) A pascal string set length (4 bytes) The length of the set device class (4 bytes) The device class of the device device identifier (4 bytes) The device identifier of the device flags (4 bytes) Same flags as in the header reserved1 (4 bytes) Reserved by apple set to zero. reserved2 (4 bytes) Reserved by apple set to zero. reserved3 (4 bytes) Reserved by apple set to zero. set resource id (2 bytes) The resource id of the set. reserved4 (2 bytes) Reserved by apple set to zero. Special Considerations ---------------------- - Your game should use the Escape key to pause and resume play. The element that corresponds to the Escape key is labelled ISpElementLabel_Start. If your game uses virtual elements then the first button need that is labelled ISpElementLabel_Start is auto- configured to the Escape key, and the user can't change this in the ISpConfigure dialog. - Your game may provide default and optional configurations for the keyboard, the mouse and any other devices. This is done by including 'setl' and 'tset' resources a resource file, such as the application's, that is open when ISpInit and ISpConfigure are called. Since the format of the 'tset' resource is determined by the device, it is easiest to use the configuration dialog to establish the desired configurations then copy them from the Preferences file into your resource file. 1. Remove the InputSprocket Preferences file from the Preferences folder. 2. Run your game, and invoke the ISpConfigure dialog. 3. Configure and save as many sets as you like for any and all devices. 4. Quit. 5. Use ResEdit to move the 'setl' and 'tset' resources to your resource file. 6. Edit the 'setl' resource using the 'TMPL' supplied in InputSprocketSimpleTest.rsrc. 7. Change the flags field to $00000002 for the default entry for a given device or $00000004 for any other entry for that device. 8. Again remove the InputSprocket Preferences file from the Preferences folder so you can test with a clean slate. 9. Rebuild your game and try out your new configurations.